﻿VALU-BASIC 2.4 - USB-STICK-FASSUNG
==================================
(English version below)

Valu-Basic läuft direkt vom USB-Stick: kostenlos, ohne Installation, ohne
Internet. Alle Daten bleiben auf dem Stick.


STARTEN UNTER WINDOWS
---------------------
1. Doppelklick auf "Windows - starten.bat".
2. Warnt Windows ("Der Computer wurde durch Windows geschützt"):
   "Weitere Informationen" anklicken, dann "Trotzdem ausführen".
3. Der Browser öffnet sich von selbst.
4. Beenden: "Windows - beenden.bat" doppelklicken - oder das schwarze
   Konsolenfenster schließen.


STARTEN AUF DEM MAC
-------------------
1. Beim ersten Mal: mit der rechten Maustaste auf "Mac - starten.command"
   klicken, "Öffnen" wählen und die Sicherheitsfrage mit "Öffnen" bestätigen.
   Ab dem zweiten Start genügt ein Doppelklick.
2. Der Browser öffnet sich von selbst.
3. Beenden: im Terminal-Fenster Ctrl+C drücken (nicht Cmd+C) - oder
   "Mac - beenden.command" (beim ersten Mal ebenfalls Rechtsklick > Öffnen).

Falls das Fenster "PHP ist auf diesem Mac nicht installiert" meldet:
Valu-Basic braucht das kostenlose Programm PHP. Apple liefert es seit
macOS 12 nicht mehr mit. So installieren Sie es einmalig:

  a) Das Programm "Terminal" öffnen (Programme > Dienstprogramme).
  b) Homebrew installieren - ein kostenloses, weit verbreitetes
     Installationsprogramm für den Mac (https://brew.sh). Diese Zeile in
     das Terminal kopieren und Enter drücken:

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

     - Der Mac fragt nach Ihrem Anmeldepasswort. Beim Tippen ist nichts
       zu sehen - einfach blind eingeben und Enter drücken.
     - Möglicherweise möchte macOS die "Befehlszeilen-Tools" installieren:
       zustimmen.
     - Das dauert etwa 10 bis 15 Minuten.
     - Am Ende zeigt Homebrew unter "Next steps" zwei Befehle an. Diese
       ebenfalls ins Terminal kopieren und ausführen.
  c) Dann eingeben:   brew install php
  d) Valu-Basic erneut starten ("Mac - starten.command").


WICHTIG
-------
- Das Konsolen- bzw. Terminal-Fenster während der Nutzung offen lassen -
  es ist der Server.
- Vor dem Abziehen des Sticks Valu-Basic beenden.
- Adresse im Browser: http://localhost:8080
- Die Daten liegen im Ordner valu-basic\data auf dem Stick. Sitzungs- und
  Temp-Dateien liegen im Ordner data neben valu-basic - nichts bleibt auf
  dem Rechner zurück.


ERSTE SCHRITTE
--------------
1. Beim ersten Start öffnet sich die Einrichtung - in der Sprache Ihres
   Browsers; unten auf der Seite lässt sie sich umstellen.
2. Administratorkonto anlegen, auf Wunsch mit drei Beispiel-Gegenständen
   (die Beispielbilder sind KI-generiert; einfach löschen).
3. Loslegen. Die Einrichtungsseite sperrt sich danach selbst.


SICHERUNG
---------
- Bei jedem Start sichert Valu-Basic die Datenbank einmal am Tag nach
  valu-basic\backups\auto - die letzten 7 Stände bleiben erhalten.
- Zurückholen: Verwaltung > Backup > Restore.
- Für den Ernstfall ab und zu die Datenbank herunterladen (Verwaltung >
  Backup) und NICHT auf demselben Stick aufbewahren.


PASSWORT VERGESSEN
------------------
Auf dem Stick gibt es keinen Mailversand. Stattdessen:
1. Doppelklick auf "Windows - Passwort vergessen.bat" bzw.
   "Mac - Passwort vergessen.command".
2. Neues Passwort zweimal eingeben (mindestens 8 Zeichen). Unter Windows
   ist es beim Tippen sichtbar, auf dem Mac nicht.
3. Eine Sperre nach zu vielen Fehlversuchen wird dabei aufgehoben. Danach
   im Browser mit dem neuen Passwort anmelden.
Valu-Basic darf dabei laufen oder beendet sein.


AUF EINE NEUE VERSION AKTUALISIEREN
-----------------------------------
1. Valu-Basic beenden und den ganzen Stick-Inhalt zur Sicherheit in einen
   Ordner auf dem Rechner kopieren.
2. Die neue ZIP-Datei entpacken und ihren INHALT auf den Stick kopieren;
   "Dateien ersetzen" bestätigen. Datenbank, Bilder, Belege und
   Sicherungen bleiben erhalten - das ZIP enthält dort nur leere Ordner.
3. Beim Update von 2.1 oder älter: die alten Startdateien
   "Valu-Basic starten.bat/.command" und "Valu-Basic beenden.bat/.command"
   löschen, ebenso README.md. Sie heißen seit 2.2 "Windows - ..." bzw.
   "Mac - ...".
4. Starten und neu anmelden.


Valu-Basic 2.4 - (c) 2025-2026 Jörg Steinhäuser - MIT-Lizenz (siehe LICENSE)
Kontakt: valusafe@palindrom.de - https://palindrom.de/valusafe/


==========================================================================

VALU-BASIC 2.4 - USB STICK EDITION
==================================

Valu-Basic runs straight from a USB stick: free, no installation, no
internet needed. All data stays on the stick.


STARTING ON WINDOWS
-------------------
1. Double-click "Windows - starten.bat" ("starten" means "start").
2. If Windows warns you ("Windows protected your PC"): click "More info",
   then "Run anyway".
3. Your browser opens by itself.
4. To quit: double-click "Windows - beenden.bat" ("beenden" means "quit") -
   or close the black console window.


STARTING ON A MAC
-----------------
1. The first time: right-click "Mac - starten.command", choose "Open" and
   confirm the security question with "Open". From then on a double-click
   is enough.
2. Your browser opens by itself.
3. To quit: press Ctrl+C in the Terminal window (not Cmd+C) - or use
   "Mac - beenden.command" (the first time also right-click > Open).

If the window says that PHP is not installed:
Valu-Basic needs the free program PHP, which Apple no longer ships since
macOS 12. Install it once like this:

  a) Open the "Terminal" app (Applications > Utilities).
  b) Install Homebrew - a free and widely used installer for the Mac
     (https://brew.sh). Paste this line into Terminal and press Enter:

     /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

     - Your Mac asks for your login password. Nothing is shown while you
       type - just type it and press Enter.
     - macOS may offer to install the "Command Line Tools": agree.
     - This takes about 10 to 15 minutes.
     - At the end Homebrew shows two commands under "Next steps". Paste
       and run them as well.
  c) Then enter:   brew install php
  d) Start Valu-Basic again ("Mac - starten.command").


IMPORTANT
---------
- Keep the console or Terminal window open while you work - it is the
  server.
- Quit Valu-Basic before you unplug the stick.
- Address in the browser: http://localhost:8080
- Your data is stored in the folder valu-basic\data on the stick. Session
  and temporary files are kept in the folder data next to valu-basic -
  nothing is left behind on the computer.


FIRST STEPS
-----------
1. On the first start the setup opens - in your browser's language; you can
   switch it at the bottom of the page.
2. Create the administrator account, optionally with three sample items
   (the sample pictures are AI-generated; simply delete them).
3. Get started. The setup page locks itself afterwards.


BACKUP
------
- Each time it starts, Valu-Basic backs up the database once a day to
  valu-basic\backups\auto - the last 7 backups are kept.
- To restore: Administration > Backup > Restore.
- Every now and then download the database as well (Administration >
  Backup) and do NOT keep it on the same stick.


FORGOTTEN PASSWORD
------------------
There is no e-mail on the stick. Instead:
1. Double-click "Windows - Passwort vergessen.bat" or
   "Mac - Passwort vergessen.command".
2. Enter the new password twice (at least 8 characters). On Windows it is
   visible while typing, on a Mac it is not.
3. A lock after too many failed attempts is lifted as well. Then sign in
   in your browser with the new password.
Valu-Basic may be running or stopped.


UPDATING TO A NEW VERSION
-------------------------
1. Quit Valu-Basic and copy the whole stick to a folder on your computer,
   just in case.
2. Unpack the new ZIP file and copy its CONTENTS onto the stick; confirm
   "Replace files". Database, pictures, receipts and backups are kept - the
   ZIP only contains empty folders there.
3. When updating from 2.1 or older: delete the old start files
   "Valu-Basic starten.bat/.command" and "Valu-Basic beenden.bat/.command"
   and README.md. Since 2.2 they are called "Windows - ..." and "Mac - ...".
4. Start Valu-Basic and sign in again.


Valu-Basic 2.4 - (c) 2025-2026 Jörg Steinhäuser - MIT licence (see LICENSE)
Contact: valusafe@palindrom.de - https://palindrom.de/valusafe/
